[Workers] Document Wrangler auth profiles by MattieTK · Pull Request #31774 · cloudflare/cloudflare-docs

MattieTK · 2026-06-29T15:11:01Z

Summary

Adds user-facing documentation for Wrangler authentication profiles (workers-sdk #14200, RFC #14161).

Profiles let you keep separate OAuth logins scoped to specific accounts and bind them to directories, so you can work across multiple Cloudflare accounts without re-running wrangler login — for example, a separate login per client at an agency, or account-separated staging and production with account_id as a failsafe.

This PR adds:

A new guide at /workers/wrangler/profiles/ covering when to use profiles, the resolution order, account selection, and the create / activate / switch / list / remove workflow.
A changelog entry (dated 2026-06-30) that summarises the use cases and links to the guide.
The wrangler auth command reference (auth create, auth activate, auth deactivate, auth list, auth delete) under the auth section in commands/general.mdx. These autogenerate from the installed wrangler package via experimental_getWranglerCommands() — including the --profile global flag and the "Experimental" badge.

To populate the autogenerated command reference, this PR bumps the wrangler devDependency to 4.106.0 (the release that ships profiles). Because that version was published within the repo's 24-hour minimumReleaseAge window, wrangler and its miniflare dependency are added to minimumReleaseAgeExclude in pnpm-workspace.yaml — the docs site bumps Wrangler frequently to regenerate command docs, so exempting these first-party packages from the age wait is intentional.

A full local build passes (8,550 pages), and the guide's per-command anchors (#auth-create, etc.) resolve against the autogenerated headings.

Documentation checklist

Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
The change adheres to the documentation style guide.
If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes. (Tracked by RFC #14161.)

github-actions · 2026-06-29T15:11:38Z

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
`package.json`	`@cloudflare/content-engineering`
`*`	`@cloudflare/product-owners`
`/src/content/changelog/`	`@cloudflare/pm-changelogs`, `@cloudflare/product-owners`
`/src/content/docs/workers/wrangler/`	`@cloudflare/wrangler`, `@irvinebroque`, `@cloudflare/product-owners`, `@MattieTK`, `@vy-ton`

ask-bonk · 2026-06-29T15:15:45Z

Recommended labels: workers, wrangler, documentation, changelog

Summary

This PR adds user-facing documentation for Wrangler authentication profiles (shipping in Wrangler 4.106.0):

New guide: src/content/docs/workers/wrangler/profiles.mdx — a concept page covering profile resolution order, directory binding, account selection, and the create / activate / switch / list / remove workflow.
Changelog entry: src/content/changelog/workers/2026-06-30-wrangler-auth-profiles.mdx announcing the feature and linking to the guide.

Overall, the content is well-structured, provides practical examples (agency multi-client work and staging/production separation), and appropriately flags the beta status. Good work.

Issues that need attention before merge

1. Grammar typo in profiles.mdx (line 11) 🔴
The opening sentence is missing a conjunction.

- A profile is a named OAuth login that you scope to a chosen set of accounts can bind to a directory.
+ A profile is a named OAuth login that you scope to a chosen set of accounts and bind to a directory.

2. Pre-merge dependency: Wrangler version bump 🔴
As noted in the PR description, the wrangler devDependency must be bumped to 4.106.0 and the <WranglerCommand> entries for auth create, auth activate, auth deactivate, auth list, and auth delete must be added to commands/general.mdx before this merges. Without that bump, the command reference anchor exists but the specific commands won't render.

3. Changelog date confirmation 🔴
The changelog date is set to 2026-06-30. This should be updated to match the actual 4.106.0 release date before merge.

4. Consider adding sidebar.order
The new guide does not set a sidebar.order. Without one, it will be sorted alphabetically among the Wrangler pages. If it should appear in a specific position (e.g., near Install/Update or Configuration), add an explicit sidebar: order: N to the frontmatter.

5. <Steps> usage for priority lists
The Resolution order and Account selection sections use the <Steps> component for declarative priority lists rather than procedural instructions. The style guide typically reserves <Steps> for sequential actions ("Do X, then do Y"). Consider using a regular numbered markdown list for these two sections, or rephrasing the items as imperative steps.

6. Unchecked documentation checklist item
The third checklist item ("If a larger change … an issue has been opened …") is unchecked, with a note that it is tracked by RFC #14161. If maintainers are satisfied that the RFC is sufficient, this is fine.

Verdict

Approve after addressing items 1–3 (grammar fix, wrangler bump, and date confirmation). The rest are optional suggestions.

github run

irvinebroque

👏 👏 👏

stamp so you have it, see comments

worth considering calling out in blog too (but not blocking on blog)

irvinebroque · 2026-06-29T15:19:14Z

+
+A profile is a named OAuth login that you scope to a chosen set of accounts and bind to a directory. Commands run in that directory, and its subdirectories, use the matching account automatically.
+
+Use profiles to keep a separate login for each client when working at an agency, or to separate staging and production into different accounts. Pair a profile with an `account_id` in your [Wrangler configuration file](/workers/wrangler/configuration/) so a command cannot reach the wrong account.


@dinasaur404 for blog re: FGA

github-actions · 2026-06-29T15:39:53Z

Preview URL: https://314e46bb.preview.developers.cloudflare.com
Preview Branch URL: https://wrangler-auth-profiles.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/workers/wrangler/profiles/	https://wrangler-auth-profiles.preview.developers.cloudflare.com/workers/wrangler/profiles/
https://developers.cloudflare.com/changelog/post/2026-06-30-wrangler-auth-profiles/	https://wrangler-auth-profiles.preview.developers.cloudflare.com/changelog/post/2026-06-30-wrangler-auth-profiles/
https://developers.cloudflare.com/workers/wrangler/commands/general/	https://wrangler-auth-profiles.preview.developers.cloudflare.com/workers/wrangler/commands/general/

Co-authored-by: Brendan Irvine-Broque <brendanib@gmail.com>

…ands

cloudflare-docs-bot · 2026-07-01T20:42:02Z

Review

⚠️ 1 warning, 💡 1 suggestion found in commit 314e46b.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

_{No code review issues found.}

Conventions

Checks PR title, description, and redirect checklist.

_{No convention issues found.}

Style Guide Review

Warnings (1)

File	Issue
`workers/wrangler/profiles.mdx` line 151	Directional words — Line uses the directional word `above` (`profile bound above it`) Fix: Replace `above` with a direct reference such as `the profile bound to an ancestor directory`

Suggestions (1)

File	Issue
`changelog/workers/2026-06-30-wrangler-auth-profiles.mdx` line 32	Use 'refer to' instead of 'see' when introducing a link — Line adds `... see [Authentication profiles](/workers/wrangler/profiles/).` Fix: Change to `... refer to [Authentication profiles](/workers/wrangler/profiles/).`

Redirects

_{No missing redirect entries found.}

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
`/review`	Runs a review now. Incremental if a prior review exists, full if not.
`/full-review`	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
`/ignore-review-limit`	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
`/disable-auto-review`	Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run `/review` or `/full-review` manually.

edmundhung · 2026-07-02T10:09:06Z

+  # Wrangler often to regenerate the autogenerated command reference, so exempt
+  # it (and its miniflare dependency) from the 24h wait.
+  - wrangler
+  - miniflare


I guess we will need to include transitive dependencies of miniflare too 😅

Suggested change

- miniflare

- miniflare

- workerd

- @cloudflare/workers-types

[Workers] Document Wrangler auth profiles

c489773

github-actions Bot added product:workers Related to Workers product product:changelog size/m labels Jun 29, 2026

github-actions Bot assigned irvinebroque and vy-ton Jun 29, 2026

irvinebroque approved these changes Jun 29, 2026

View reviewed changes

MattieTK and others added 4 commits June 29, 2026 17:22

Apply suggestions from code review

5008a9f

Co-authored-by: Brendan Irvine-Broque <brendanib@gmail.com>

[Workers] Bump Wrangler to 4.106.0 and autogenerate auth profile comm…

d292822

…ands

[Workers] Fix doubled word in auth profiles changelog

289261d

[Workers] Reframe auth profiles changelog around current capability

314e46b

MattieTK marked this pull request as ready for review July 1, 2026 20:41

MattieTK requested review from a team and vy-ton as code owners July 1, 2026 20:41

MattieTK requested a review from edmundhung July 1, 2026 20:41

edmundhung approved these changes Jul 2, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[Workers] Document Wrangler auth profiles#31774

[Workers] Document Wrangler auth profiles#31774
MattieTK wants to merge 5 commits into
productionfrom
wrangler-auth-profiles

MattieTK commented Jun 29, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 29, 2026 •

edited

Loading

Uh oh!

ask-bonk Bot commented Jun 29, 2026

Uh oh!

irvinebroque left a comment

Uh oh!

Uh oh!

Uh oh!

irvinebroque Jun 29, 2026

Uh oh!

Uh oh!

github-actions Bot commented Jun 29, 2026 •

edited

Loading

Uh oh!

cloudflare-docs-bot Bot commented Jul 1, 2026 •

edited

Loading

Uh oh!

edmundhung Jul 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		A profile is a named OAuth login that you scope to a chosen set of accounts and bind to a directory. Commands run in that directory, and its subdirectories, use the matching account automatically.

		Use profiles to keep a separate login for each client when working at an agency, or to separate staging and production into different accounts. Pair a profile with an `account_id` in your [Wrangler configuration file](/workers/wrangler/configuration/) so a command cannot reach the wrong account.

Uh oh!

Conversation

MattieTK commented Jun 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Documentation checklist

Uh oh!

github-actions Bot commented Jun 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ask-bonk Bot commented Jun 29, 2026

Summary

Issues that need attention before merge

Verdict

Uh oh!

irvinebroque left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

irvinebroque Jun 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jun 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cloudflare-docs-bot Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review

Code Review

Conventions

Style Guide Review

Redirects

Uh oh!

edmundhung Jul 2, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

MattieTK commented Jun 29, 2026 •

edited

Loading

github-actions Bot commented Jun 29, 2026 •

edited

Loading

github-actions Bot commented Jun 29, 2026 •

edited

Loading

cloudflare-docs-bot Bot commented Jul 1, 2026 •

edited

Loading